home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xt / XtSetSensitive.z / XtSetSensitive
Encoding:
Text File  |  1998-10-30  |  3.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXttttSSSSeeeettttSSSSeeeennnnssssiiiittttiiiivvvveeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333)))) XXXXttttSSSSeeeettttSSSSeeeennnnssssiiiittttiiiivvvveeee((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtSetSensitive, XtIsSensitive - set and check a widget's
  10.           sensitivity state
  11.  
  12.      SSSSYYYYNNNNTTTTAAAAXXXX
  13.           void XtSetSensitive(_w, _s_e_n_s_i_t_i_v_e)
  14.                 Widget _w;
  15.                 Boolean _s_e_n_s_i_t_i_v_e;
  16.  
  17.           Boolean XtIsSensitive(_w)
  18.                Widget _w;
  19.  
  20.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  21.           _s_e_n_s_i_t_i_v_e Specifies a Boolean value that indicates whether
  22.                     the widget should receive keyboard and pointer
  23.                     events.
  24.  
  25.           _w         Specifies the widget.
  26.  
  27.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  28.           The _X_t_S_e_t_S_e_n_s_i_t_i_v_e function first calls _X_t_S_e_t_V_a_l_u_e_s on the
  29.           current widget with an argument list specifying that the
  30.           sensitive field should change to the new value.  It then
  31.           recursively propagates the new value down the managed
  32.           children tree by calling _X_t_S_e_t_V_a_l_u_e_s on each child to set
  33.           the ancestor_sensitive to the new value if the new values
  34.           for sensitive and the child's ancestor_sensitive are not the
  35.           same.
  36.  
  37.           _X_t_S_e_t_S_e_n_s_i_t_i_v_e calls _X_t_S_e_t_V_a_l_u_e_s to change sensitive and
  38.           ancestor_sensitive.  Therefore, when one of these changes,
  39.           the widget's set_values procedure should take whatever
  40.           display actions are needed (for example, greying out or
  41.           stippling the widget).
  42.  
  43.           _X_t_S_e_t_S_e_n_s_i_t_i_v_e maintains the invariant that if parent has
  44.           either sensitive or ancestor_sensitive _F_a_l_s_e, then all
  45.           children have ancestor_sensitive _F_a_l_s_e.
  46.  
  47.           The _X_t_I_s_S_e_n_s_i_t_i_v_e function returns _T_r_u_e or _F_a_l_s_e to indicate
  48.           whether or not user input events are being dispatched.  If
  49.           both core.sensitive and core.ancestor_sensitive are _T_r_u_e,
  50.           _X_t_I_s_S_e_n_s_i_t_i_v_e returns _T_r_u_e; otherwise, it returns _F_a_l_s_e.
  51.  
  52.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  53.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  54.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.